Augment Task

## Augment

### Description

Modify an existing reference by adding nested elements or (re-)assigning properties mapped as XML attributes. This is an unusual task that makes use of Ant's internal processing mechanisms to reload a previously declared reference by means of the 'id' attribute, then treats the declared `augment` element as though it were the original element. Since Apache Ant 1.8.1

### Parameters

Attribute | Description | Required
id | The id of the reference to augment. If no such reference has been declared a `BuildException` is generated. | Yes

Additional permissible attributes are dependent on the reference to be modified.

### Parameters specified as nested elements

Permissible nested elements are dependent on the reference to be modified.

### Examples

Given

      <fileset id="input-fs" dir="${basedir}" />

      <augment id="input-fs" excludes="foo" />

Modifies the `excludes` attribute of `input-fs`.

      <augment id="input-fs">
        <filename name="bar" />
      </augment>

Adds a `filename` selector to `input-fs`.